Skip to content

Add HttpOnly flag to synthetic ID cookie#507

Open
prk-Jr wants to merge 4 commits intomainfrom
fix/synthetic-id-cookie-httponly
Open

Add HttpOnly flag to synthetic ID cookie#507
prk-Jr wants to merge 4 commits intomainfrom
fix/synthetic-id-cookie-httponly

Conversation

@prk-Jr
Copy link
Collaborator

@prk-Jr prk-Jr commented Mar 16, 2026

Summary

  • The synthetic_id cookie was missing HttpOnly, allowing XSS on a publisher page to exfiltrate the tracking identifier via document.cookie.
  • HttpOnly is safe to add because no client-side JS reads this cookie — integrations receive the synthetic ID via the x-synthetic-id response header instead.
  • Adds debug_assert! guards against cookie metacharacter injection in both the synthetic_id value and cookie_domain, and documents the rationale for each security attribute in the function's doc comment.

Changes

File Change
crates/common/src/cookies.rs Add HttpOnly to cookie format string; add debug_assert! metacharacter guards; update doc comment to enumerate all security attributes with rationale

Closes

Closes #411

Test plan

  • cargo test --workspace
  • cargo clippy --all-targets --all-features -- -D warnings
  • cargo fmt --all -- --check
  • JS tests: cd crates/js/lib && npx vitest run — pre-existing ESM/CJS failure on main, unrelated to this change
  • JS format: cd crates/js/lib && npm run format
  • Docs format: cd docs && npm run format
  • WASM build: cargo build --bin trusted-server-fastly --release --target wasm32-wasip1
  • Manual testing via fastly compute serve

Checklist

  • Changes follow CLAUDE.md conventions
  • No unwrap() in production code — use expect("should ...")
  • Uses tracing macros (not println!)
  • New code has tests
  • No secrets or credentials committed

The synthetic_id cookie was missing the HttpOnly attribute, allowing
any XSS on a publisher page to exfiltrate the tracking identifier via
document.cookie.

HttpOnly is safe to set because integrations receive the synthetic ID
via the x-synthetic-id response header and no client-side JS reads it
from the cookie directly.

Also documents the rationale for each security attribute (Secure,
HttpOnly, SameSite=Lax, Max-Age) in the doc comment, and adds
debug_assert guards against cookie metacharacter injection in both
the synthetic_id value and cookie_domain.

Closes #411
@prk-Jr prk-Jr self-assigned this Mar 16, 2026
Copy link
Collaborator

@ChristianPavilonis ChristianPavilonis left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Review Summary

Clean, well-scoped security hardening. The HttpOnly addition is correct, the doc comment is excellent, and the change is minimal. One concern about the debug_assert! approach and a few smaller items below.

0 Blockers · 1 High · 3 Medium

/// - `SameSite=Lax`: sent on same-site requests and top-level cross-site navigations.
/// `Strict` is intentionally avoided — it would suppress the cookie on the first
/// request when a user arrives from an external page, breaking first-visit attribution.
/// - `Max-Age`: 1 year retention.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 — Missing # Panics doc section

Per project conventions, functions that can panic should document it. The debug_assert! macros below will panic in debug/test builds. Consider adding:

/// # Panics
///
/// Panics in debug builds if `synthetic_id` or `cookie_domain` contains
/// cookie metacharacters (`;`, `=`, `\n`, `\r`).

Copy link
Collaborator

@ChristianPavilonis ChristianPavilonis left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@prk-Jr sorry the previous review didn't have clear suggestions.

Solid, well-scoped security fix. The HttpOnly addition is correct and the doc comment is excellent. Three actionable findings — two about the sanitization approach, one about the assert!.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Synthetic ID cookie missing HttpOnly flag

2 participants